home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung / Power-Programmierung (Tewi)(1994).iso / magazine / nan_news / toolkit / acctadj.prg < prev    next >
Text File  |  1991-08-15  |  3KB  |  108 lines
  1. /*
  2.  * File......: ACCTADJ.PRG
  3.  * Author....: Jo W. French dba Practical Computing
  4.  * CIS ID....: 74731,1751
  5.  * Date......: $Date:   15 Aug 1991 23:04:58  $
  6.  * Revision..: $Revision:   1.3  $
  7.  * Log file..: $Logfile:   E:/nanfor/src/acctadj.prv  $
  8.  * 
  9.  * The functions contained herein are the original work of Jo W. French
  10.  * and are placed in the public domain.
  11.  *
  12.  * Modification history:
  13.  * ---------------------
  14.  *
  15.  * $Log:   E:/nanfor/src/acctadj.prv  $
  16.  * 
  17.  *    Rev 1.3   15 Aug 1991 23:04:58   GLENN
  18.  * Forest Belt proofread/edited/cleaned up doc
  19.  * 
  20.  *    Rev 1.2   14 Jun 1991 19:50:40   GLENN
  21.  * Minor edit to file header
  22.  * 
  23.  *    Rev 1.1   11 May 1991 00:34:00   GLENN
  24.  * Documentation rewrite.  Enter DOC header was rewritten and resubmitted
  25.  * by the author.  No code changes.
  26.  * 
  27.  *    Rev 1.0   01 Apr 1991 01:00:22   GLENN
  28.  * Nanforum Toolkit
  29.  *
  30.  */
  31.  
  32.  
  33. /*  $DOC$
  34.  *  $FUNCNAME$
  35.  *     FT_ACCTADJ()
  36.  *  $CATEGORY$
  37.  *     Date/Time
  38.  *  $ONELINER$
  39.  *     Adjust beginning or ending fiscal pd. dates to acctg. dates
  40.  *  $SYNTAX$
  41.  *     FT_ACCTADJ( [ <dGivenDate> ], [ <lIsEnd> ] ) -> dDate
  42.  *  $ARGUMENTS$
  43.  *     <dGivenDate> is any valid date in any valid format.
  44.  *     Defaults to DATE() if not supplied.
  45.  *
  46.  *     <lIsEnd> is a logical variable. .F. = adjust for beginning of
  47.  *     period mode, .T. = adjust for end of period mode.  Defaults to
  48.  *     beginning of period mode.
  49.  *  $RETURNS$
  50.  *     An adjusted date dependent upon mode and work week start day.
  51.  *  $DESCRIPTION$
  52.  *     Called by other FT_ACCT.. functions. The algorithm is:
  53.  *
  54.  *     Beginning of period mode:
  55.  *
  56.  *        If dGivenDate is in last 3 days of work week
  57.  *           Return next week's start date
  58.  *        Else
  59.  *           Return this week's start date
  60.  *        Endif
  61.  *
  62.  *     End of period mode:
  63.  *
  64.  *        If dGivenDate is in last 4 days of work week
  65.  *           Return this week's end date
  66.  *        Else
  67.  *           Return prior week's end date
  68.  *        Endif
  69.  *  $EXAMPLES$
  70.  *     Beginning of period mode (lIsEnd == .F.)
  71.  *
  72.  *       dDate := Ctod( "01/31/91" )  // In last 3 days of work week
  73.  *       ? FT_ACCTADJ( dDate )        // 02/03/91 (next week's start)
  74.  *
  75.  *       dDate := Ctod( "03/31/91" )  // Not in last 3 days of work week
  76.  *       ? FT_ACCTADJ( dDate )        // 03/31/91 (this week's start)
  77.  *
  78.  *     End of period mode (lIsEnd == .T.)
  79.  *
  80.  *       dDate := Ctod( "01/31/91" )  // In last 4 days of work week
  81.  *       ? FT_ACCTADJ( dDate, .T. )   // 02/02/91 (this week's end)
  82.  *
  83.  *       dDate := Ctod( "03/31/91" )  // Not in last 4 days of work week
  84.  *       ? FT_ACCTADJ( dDate, .T. )   // 03/30/91 (prior week's end)
  85.  *  $SEEALSO$
  86.  *     FT_DATECNFG() FT_DAYTOBOW()
  87.  *  $END$
  88. */
  89.  
  90. FUNCTION FT_ACCTADJ(dGivenDate, lIsEnd)
  91.  
  92.   LOCAL nTemp
  93.  
  94.   dGivenDate := IIF(VALTYPE(dGivenDate) != 'D', DATE(), dGivenDate)
  95.   lIsEnd     := IIF(VALTYPE(lIsEnd) != 'L', .F., lIsEnd)
  96.   nTemp      := FT_DAYTOBOW(dGivenDate)
  97.  
  98.   IF nTemp > ( 2 + IF(!lIsEnd, 1, 0) )
  99.      dGivenDate += ( 7 - nTemp )      // Next Week Start (This Week End + 1)
  100.   ELSE
  101.      dGivenDate -= nTemp              // This Week Start (Prior Week End + 1)
  102.   ENDIF
  103.  
  104.   dGivenDate := dGivenDate - IIF(lIsEnd, 1 , 0)
  105.  
  106. RETURN dGivenDate
  107.  
  108.